home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / hardware / mousev1b.lzh / MouseV1.PKG / README.TXT < prev   
Text File  |  1995-11-19  |  9KB  |  172 lines
  1.  
  2. Mouse V1.0
  3.  
  4. November 20, 1995
  5.  
  6. Turn your Newton into a Drawing Tablet for your computer !
  7.  
  8. This is "Mouse", a serial mouse emulator for MicroSloth PC's and Amiga's,
  9. and if the drivers are available, UNIX/LINUX machines with serial mouse capability.
  10. It is a really GREAT example of HOW NOT TO program the Newton.
  11.  
  12. Inspired by NewtTablet, which turns the Newton into a Mac Mouse (only works on 
  13. some Macs).
  14.  
  15. You should be able to read this file okay, MOUSE.ZIP was put on a PC before archival.
  16.  
  17. Source code is available for  NTK 1.5, DOS, Amiga or Mac disk format.
  18.  
  19. Semi Legal Junk :
  20.      Except for the mouse drivers, which are freely redistributable, 
  21.      everything in this archive is copyrighted by ME, the author.  You may freely
  22.      distribute it, and may NOT sell it.  You MAY use it for educational purposes and fun,
  23.      you MAY NOT use it to conquer the world or other nefarious schemes.
  24.  
  25.      It is provided "As Is" with no warranty, use at your own risk, read the bug report
  26.      below before using.  Back up your Newton before using.  WARNING : This is
  27.      my first effort at programming the Newton, I've tested it to the best of my ability.
  28.  
  29.      Distribution MUST include all files listed below.
  30.  
  31.     If this distribution is incomplete please delete it and email me for a complete
  32.     copy : Paul Cimino, cimino@mdso.vf.ge.com 
  33.  
  34. What's here :
  35.      Mouse.pkg                     Newton Serial Mouse emulation package
  36.      README.TXT                    This file
  37.      AMIGA.UTL                     A directory containing Amiga files :  mouse drivers
  38.                                                  which allow the Amiga to use a serial mouse,
  39.                                                  some with source code
  40.      IBMPC.UTL                     A directory with PC mouse driver
  41.  
  42. Getting Started :
  43.      Load the Mouse.pkg as you normally would, with the Connection Kit, or
  44.      (I highly recommend) YAPI, by Scott Herndon SHern@eworld.com 
  45.      (see History, below).
  46.  
  47.      Once loaded, connect the Newton via NULL modem cable.  Find an Apple modem
  48.      cable (8 pin DIN to 25 D-Sub connector).  You may need a NULL modem adapter,
  49.      a gender changer and possibly a 25-Pin to 9-Pin adapter.  Any and all of these
  50.      things are available (expensively) from CompUSA or similar.  You can get them
  51.      cheap mail order.  I believe the cable that comes with PC Connection Kit will 
  52.      work as is, a 25 pin to 9 pin adapter is included.  Or you can order a cable
  53.      from me, which will work with YAPI. (See CABLES, Below)
  54.  
  55.      Now load the driver on the computer and start "Mouse".  Hit the "Connect" button
  56.      and you're ready to go.    
  57.  
  58. Use :
  59.      First thing you may want to do is press the "Cal" (Calibrate) button.  This should
  60.      move the pointer on your computer screen to the Upper Left Hand corner.  You may
  61.      may notice a mark in the upper left corner of the box of the Newton "Mouse"
  62.      screen.  Draw a line in the Mouse box and watch your screen.  Mouse draws a line
  63.      following your movements and puts a mark where you left the pointer.  You do
  64.      not have to put your pen down where you stopped, Mouse remembers (sort of, see 
  65.      the bug report) where you left off.
  66.  
  67.      Notice the faster you move your pen, the faster the mouse moves (see bug report)
  68.  
  69.      The Calibrate button I already mentioned.
  70.  
  71.      Connect/Disconnect hooks you up with your computer.
  72.  
  73.      The Erase button wipes the Screen clean, but leaves the marker in the last position.
  74.  
  75.      Manual/Automatic Button toggles drawing behavior.  Manual let's you do the "Erase"
  76.      while Automatic keeps the screen uncluttered.
  77.  
  78.      The "Right" and "Left" buttons correspond to tapping the mouse right or left
  79.      button (sorry, no middle key).  Similarly, the "Hold" buttons hold down the 
  80.      listed key, so you can do things like move down a menu, drag and drop, etc.
  81.  
  82. About the screen size :
  83.      Originally, I intended to use a scaling factor so one screen width on the Newton
  84.      but you would lose resolution (Each Newt pixel = n CRT pixels). So the
  85.      Label Picker for screen modes DOES NOT DO ANYTHING YET !  I hope to add capability
  86.      to this program to scroll the screen around as you move the pen closer to the edge.
  87.      In the mean time, you can draw horizontal lines or vertical until the mouse
  88.      moves to where you want, the screen Newton screen won't look pretty, but oh well.
  89.      Hopefully I can fix this little problem.
  90.  
  91.      At the time of this writing, I would like to add :
  92.           New Auto mode, which only draws lines when one of the keys is held down,
  93.           and a scrolling drawing area, since the Newt drawing area is much smaller than
  94.           any PC screen, and scaling would result in lost resolution.
  95.  
  96. Bugs:
  97.      I still need to learn more about communication endpoints and exception handling.
  98.      As a result, Mouse works fine when you connect it, but after you disconnect, you
  99.      can not reconnect, you have to exit Mouse and restart.
  100.  
  101.      For some reason, if you draw on the Newton screen too fast, it messes up
  102.     the last end point for the line.  I've noticed similar bugs in programs using
  103.     the Newton's drawing routines.
  104.  
  105. History :
  106.      I think the Newton is great, but I really love my Amiga (I won't bore you
  107.      with how great it is, ahead of it's time, still pretty impressive for a PC,
  108.      or even compared to some work stations, yadda yadda yaddda)
  109.  
  110.      One of my biggest complaints about Apple is their overwhelming desire
  111.      to make every aspect of their machine proprietary.  There are always good
  112.      reasons to make your own design, but anything that communicates with the 
  113.      outside world should be as flexible and open as possible (i.e. the Serial
  114.      Port and any communication protocals being used) unless you are actually
  115.      adding value, and not just trying to lock up your market in a strangle hold.
  116.  
  117.      This is why I like YAPI so much, it allows package installation from any
  118.      computer with XModem and the proper cable (see below).
  119.  
  120.      I am working on a program which makes Newton books on the Amiga/Unix 
  121.      platforms,  similar to Paperback (another excellent
  122.      program) which is available for Macs and IBM.
  123.  
  124.      I would also like to figure out the Newton protocal, allowing package installation
  125.      onto the Newton without YAPI.  I have finally received my Apple License package
  126.      which includes info on the Newton package formats.  So hopefully I'll be able
  127.      to find time to put into these efforts.
  128.  
  129.      A compiler would be nice.  I know of one person working on a Gnu compiler for
  130.      the Newton : Ross Sponholtz, ross@wwa.com, http://miso.wwa.com/~ross
  131.  
  132. CABLES :
  133.      To use Mouse, you need a Null modem cable with an 8 Pin DIN for the Newton,
  134.      and the appropriate connector on the other end.  Sparc (I'd like to see a serial
  135.      mouse on a Sparc !  :-)   ) users just need the standard Apple cable, 8 Pin DIN on
  136.      both ends.
  137.  
  138.      Most PC users can buy an Apple Modem cable, which has a DB 25 connector on one
  139.      end, then buy a Null Modem adapter, a Gender Changer, and if needed, a 25 to 9 pin
  140.      adapter.  If you own the PC Connection Kit, you're all set.
  141.  
  142.      However, these cables will not work with YAPI because you must have the proper
  143.      wiring for the Hardware Handshake.  PCs mostly use software error checking, 
  144.      so the cables usually lack the right wire.  Rumor has it you can get a 
  145.      Mac<=>Modem cable WITH the correct wiring, I haven't seen it myself.
  146.  
  147.      If you'd like to order a cable from me, I will provide a NULL Modem cable which
  148.      will work with YAPI, and have a DB25 FEMALE or DB9 FEMALE connector on one
  149.      end, and an Apple 8 pin DIN on the other.  Price is $20 prepaid, includes S&H in
  150.      the continental US.  I probably won't be making any money at that price,
  151.      and you can probably get it cheaper if you can find someone who sells the 
  152.      correct cable.
  153.  
  154.      Source code is also available for "Mouse", send $10 US (domestic mail only,
  155.      $20 foreign delivery US funds)  to me, specify Amiga, PC or Mac disk. 
  156.      I can be contacted at :
  157.  
  158.           Paul Cimino
  159.           564 Worthington Rd
  160.           Chester Springs, PA 19425
  161.  
  162.           cimino@mdso.vf.ge.com  OR on CompuServe 73677,1761
  163.  
  164.      If you try to reach me via CompuServe, I may be slow getting back to you.
  165.     
  166. Semi Legal Junk :
  167.  
  168. Amiga is a registered trade mark of Escom Gmb
  169. MacIntosh, NTK, Newton, and NewtonScript are registered trade marks of Apple.
  170. RunNewt is copyrighted by Steve Weyer (weyer@netaxs.com)
  171. Paperback is by David Fedor
  172.